home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dvball10.arc / DVBALLS.DOC < prev    next >
Text File  |  1991-09-27  |  6KB  |  130 lines
  1.                                   DVBALLS
  2.                           Version 1.0  27-Sep-91
  3.                              by Monte Ferguson
  4.  
  5.  NOTE: DVBALLS is a DESQview specific program - it will NOT run unless 
  6. you're using DESQview 2.01 or higher. 
  7.  
  8.                                 WHAT IT IS
  9.  
  10.  DVBALLS is a silly DESQview demo program.  I wrote it to familiarize 
  11. myself with the DV interprocess communication API calls. 
  12.  
  13.  The idea is to run more than one copy of DVBALLS at a time - then watch 
  14. the copies bounce little "balls" around inside their windows, passing them 
  15. back and forth between one another.
  16.  
  17.                                HOW TO RUN IT
  18.  
  19.  Use the "Add a Program" command from DV's Open menu to add the BL-PIF.DVP 
  20. file (which you should have got with this DOC file and DVBALLS.EXE) to 
  21. your DESQview menu. You may need to modify the paths or keystrokes... See 
  22. your DV manual for instructions if you're lost.
  23.  
  24.  Now, open BL from the Open menu - the first time you run DVBALLS, the 
  25. program becomes the Ball Server.  Every subsequent time you run BL (once 
  26. you have a Sever running) that "instance" of BL will be a Client.  Try 
  27. it, open BL twice.
  28.  
  29.  You should have two DV windows open, one called DVBalls Server, and one 
  30. called DVBalls Client #1.  Now switch to the Server window and press B to 
  31. add a ball.  A little ball (ok, it's square) will start bouncing around 
  32. the window.
  33.  
  34.  Notice the following things:
  35.  
  36.  A) The Server program will have a "1" somewhere in it's window - that 
  37. is the "hole" that leads to Client #1 (if you open another BL instance, 
  38. you'll get a Clint #2 and a digit 2 in the server window, and so on). If a 
  39. ball hits a digit, the ball "falls" to that client. 
  40.  
  41.  B) Each Client program will have the letter "S" somewhere in it's window. 
  42. This is the "hole" that leads back up to the server - if a ball hits an S 
  43. it's passed back to the server.
  44.  
  45.  That's essentially it.  The balls bounce around between the windows... 
  46. which doesn't *sound* particulary interesting unless you realize that each 
  47. "window" is actually a separate EXE running under DV.
  48.  
  49.                             BELLS AND WHISTLES
  50.  
  51.  Here are some keys that do things:
  52.  
  53.  B - Adds another ball.  Only works in the Server window. You can have up 
  54. to 10 balls bouncing around at once - that 10 TOTAL between the Sever and 
  55. it's Clients.
  56.  
  57.  A - Show letters instead of the "block". This acts as a toggle, and will 
  58. make it easier to track the progress of individual balls. Note that the 
  59. letter toggle works only on the instance you currently have selected - ie, 
  60. if you toggle letters on in the Server it won't toggle the clients.
  61.  
  62.  S - Shuffle. In the Server, the S key will make all the client "holes" 
  63. (numbers) move to random spots, as well as moving all the balls to the 
  64. upper left-hand corner. In a Client the S key moves the server hole.
  65.  
  66.  - (minus sign) In the Server this will throw away a ball (if there are 
  67. any in the Server window). In a client the minus key will send all it's 
  68. balls back to the server.
  69.  
  70.  1 through 9 - Only works in the Server. Will send a ball (if there are 
  71. any in the Server's window) to the client number you press.
  72.  
  73.  O - Will "hide" the holes, so balls can't leave the window. Press S 
  74. (Shuffle) to bring the holes back.
  75.  
  76.  Esc - will close that instance.  
  77.  
  78.  NOTES ON CLOSING: If you close an instance with either the Esc key or the 
  79. Close Window command from the DV menu, everything will shut down nicely. 
  80. If you're closing a client, it will notify the Server of it's passing, and 
  81. take any balls it had with it to the bit bucket.  If you close the Server 
  82. it will notify all clients to shut down as well (a quick way to stop all 
  83. the action). 
  84.  
  85.  IF, on the other hand, you shut down by using Ctrl-Alt-Del (or, heaven 
  86. forbid, a Bug crashes an instance!), the other windows will get ticked. 
  87. Sooner or later you'll get a complaint from DESQview that a "program 
  88. error" has occured... just press Esc and the window will shut down.
  89.  
  90.                                   LIMITS
  91.  
  92.  This release of DVBALLS supports up to 9 clients and up to 10 balls. The 
  93. Server window shows you which clients and balls have been allocated on the 
  94. 1st line.
  95.  
  96.                                DISTRIBUTION
  97.  
  98.  This program is copyright (C) 1991 by Monte Ferguson.  You may use it as 
  99. you will and distribute it as you will. Have fun.
  100.  
  101.  Guarantee: This program works to my satisfaction on my machine. That's 
  102. the ONLY guarantee you get. If you can't get it to work, or you find a 
  103. bug, that's just tough luck for you.
  104.  
  105.  If you would like the source code, that'll cost you $10.00.  NOTE: you 
  106. can NOT compile the program without Quarterdeck's API libraries for 
  107. QuickBASIC!  You Have Been Warned: Don't send me ten bucks and then whine 
  108. because you can't compile the code if you haven't bought the libs... NO 
  109. REFUNDS. And NO I won't send you a copy of the libs, that's piracy.
  110.  
  111.                               TECHNICAL STUFF
  112.  
  113.  This program was written in Microsoft QuickBASIC 4.5, using the 
  114. Quarterdeck DESQview API Basic Library. For people who care about such 
  115. things, it's about 600 lines of code. I don't promise that this is the 
  116. best code in the world, I wrote it seat-of-the-pants as a learning 
  117. exercise.
  118.  
  119.                                   AUTHOR
  120.  
  121.                               Monte Ferguson
  122.                               PFG Consulting
  123.                         1250 Anita Drive Suite #304
  124.                               Kent, OH  44240
  125.  
  126.  
  127. Release History:
  128.  
  129. 1.0:  First Release.
  130.